Apache ActiveMQ ™ -- Multicast Transport Reference

Using ActiveMQ > Configuring Transports > ActiveMQ Connection URIs > Multicast Transport Reference

The Multicast Transport

The Multicast transport allows clients to connect to a remote ActiveMQ broker using multicast

Note that by default Multicast is not reliable; datagrams can be lost so you should add a reliability layer to ensure the JMS contract can be implemented on a non-reliable transport.

Configuration Syntax

multicast://address:port?transportOptions

Transport Options

Option Name

Default Value

Description

group

default

specify a unique group name that can segregate multicast traffic

minmumWireFormatVersion

0

The minimum version wireformat that is allowed

trace

false

Causes all commands that are sent over the transport to be logged

useLocalHost

true

When true, it causes the local machines name to resolve to "localhost".

datagramSize

4 * 1024

Specifies the size of a datagram

timeToLive

-1

The time to live of datagrams. Set greater than 1 to send packets beyond the local network. (NOTE: This won't work for IPv4 addresses without setting the property java.net.preferIPv4Stack=true. For more info see the IPv6 User Guide for JDK)

loopBackMode

false

Should loopback mode be used

wireFormat

default

The name of the WireFormat to use

wireFormat.*

All the properties with this prefix are used to configure the wireFormat. See Configuring Wire Formats for more information

Example URIs

To use the default value of "multicast://239.255.2.3:6155" with a default multicast group name of "default" from MulticastDiscoveryAgent use

multicast://default

To specify the IP address and port use

multicast://224.1.2.3:6255

To specify a multicast group name other than the default name of "default" use

multicast://224.1.2.3:6255?group=mygroupname